Skip to content

docs(changelog): platform token spend now actually bills#89

Merged
indykish merged 2 commits into
mainfrom
chore/m90-004-token-splits-changelog
Jun 12, 2026
Merged

docs(changelog): platform token spend now actually bills#89
indykish merged 2 commits into
mainfrom
chore/m90-004-token-splits-changelog

Conversation

@indykish

@indykish indykish commented Jun 11, 2026

Copy link
Copy Markdown
Contributor

Changelog entry for usezombie#399 — the runner split-token billing fix.

Platform-model runs were charged run-fee-only because the runner never reported its token counts; it now streams cumulative input/output counts on every renewal and the final report. The entry documents the renew/report body shape, the zero-default wire compatibility (mixed fleet safe both directions), and the cached-input-0 limitation.

Decoupled from the binary VERSION per the changelog convention (date label, no semver prefix). Distinct Jun 12 block from the M91 memory-observability entry already on main.

🤖 Generated with Claude Code

Greptile Summary

Adds a changelog entry for the runner split-token billing fix: platform-model runs previously settled token spend at zero because the runner never reported token counts; it now does, so the token component of every platform run bills correctly going forward.

  • New <Update> block (Jun 12, 2026, "Bug fixes") explains the under-billing root cause, instructs operators to upgrade their runner fleet, and notes the cached-input limitation.
  • The entry follows AGENTS.md conventions: correct Upgrading → Bug fixes section order, MMM DD, YYYY date label, no semver prefix, and no runner RPC wire-format internals exposed.

Confidence Score: 5/5

Documentation-only change with no executable code; safe to merge.

The change adds a single changelog entry. Section order, date format, terminology, and content boundaries all conform to AGENTS.md. The previous concerns about section ordering and internal RPC protocol exposure are no longer present in this version. No operator-visible behavior changes.

No files require special attention.

Important Files Changed

Filename Overview
changelog.mdx Adds a new Jun 12 <Update> block documenting the runner token-billing fix; section order, date format, and terminology all conform to AGENTS.md conventions.

Sequence Diagram

sequenceDiagram
    participant Runner
    participant ControlPlane as Control Plane
    participant Billing

    Note over Runner,Billing: Before fix — token counts never reported
    Runner->>ControlPlane: POST /renew (no token fields)
    ControlPlane->>Billing: "Charge run-fee only (token_count = 0)"

    Note over Runner,Billing: After fix — cumulative counts streamed
    Runner->>ControlPlane: POST /renew (input_tokens, output_tokens)
    ControlPlane->>Billing: Charge run-fee + token component
    Runner->>ControlPlane: POST /report (final input_tokens, output_tokens)
    ControlPlane->>Billing: Final token reconciliation

    Note over Runner,ControlPlane: Older runner (zero defaults)
    Runner->>ControlPlane: POST /renew (no token fields → default 0)
    ControlPlane->>Billing: Charge run-fee only (backward compatible)
Loading

Reviews (2): Last reviewed commit: "docs(changelog): keep token-billing entr..." | Re-trigger Greptile

Context used:

  • Context used - AGENTS.md (source)

User-facing entry for the runner split-token billing fix: platform-model
runs were charged run-fee-only because the runner never reported its token
counts; it now streams cumulative input/output counts on every renewal and
the final report. Documents the renew/report body shape, the zero-default
wire compatibility (mixed fleet safe both directions), and the cached-input
0 limitation until the provider layer surfaces cache reads.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Comment thread changelog.mdx Outdated
Comment thread changelog.mdx Outdated
@mintlify

mintlify Bot commented Jun 11, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
megam 🟢 Ready View Preview Jun 11, 2026, 10:37 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

…tile P1/P2)

The API reference block documented the /v1/runners/me/* renew/report
wire shape — internal runner↔control-plane RPC, which AGENTS.md keeps
out of operator docs. Removed it and softened the lead to drop the
empty-body/field-shape specifics; the user-facing story (platform token
spend now bills; update your runner fleet) and the cached-input caveat
stay. Removing the API reference section also fixes the section-order
inversion (Bug fixes had preceded API reference). Dropped the now-unused
"API" tag.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@indykish indykish merged commit 11cb2de into main Jun 12, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant